feat: Add custom agents and skills for Ignite UI CLI by Marina-L-Stoyanova · Pull Request #1840 · IgniteUI/igniteui-cli

Marina-L-Stoyanova · 2026-10-09T08:33:56Z

Description

Adds AI agent skills for maintaining the CLI's project and component templates.

Skills live in .agents/skills/<name>/SKILL.md (Agent Skills format). VS Code Copilot discovers them automatically: you ask for the task and it loads the matching skill. Any other assistant can use one when you name its file. .agents/README.md is the guide.

This PR changes documentation only. No CLI, template or MCP server code is touched.

Skills

Skill	Kind	What it does
`igniteui-cli-template-version-update`	Workflow	Updates the Ignite UI versions that `ig new` / `ig add` scaffold, for Angular, React and Web Components. Applies patch and minor updates only. Finds every pin (constants, project `package.json` files, hard-coded `this.packages`), checks peer ranges, and validates with the template specs and the smoke test. `dry-run` mode gives a read-only report of stale pins and peer conflicts.
`igniteui-cli-component-template`	Workflow	Adds a component template (`ig add <id>`) for Angular, React and/or Web Components. Checks every API it uses against the package version that is currently pinned, reuses the same id across frameworks, and validates with the template specs, the smoke test and checks inside the generated project (type-check, lint, test file).
`igniteui-cli-changelog`	Workflow	Drafts, or with `write` inserts, the `CHANGELOG.md` section for a release cut, built from the PRs merged since the previous cut and written in the existing style.
`igniteui-cli-smoke-test`	Reference	Build, running one spec file, the specs that guard templates, running `scripts/smoke-test.sh`, what a PASS proves per framework, checks inside a kept project, and failure triage.
`igniteui-cli-template-anatomy`	Reference	Template layout per framework, `index.ts` fields, placeholders, model templates to copy, every place a version is pinned (with search patterns), which package provides which component, and how to audit which templates exist in which framework.

Other changes

AGENTS.md (new): build/test/lint, architecture, MCP server notes, conventions, and the Maintenance Workflows rules. It is based on the previous CLAUDE.md content, updated so that:
- npm run build is listed as also building the MCP server;
- running a single spec uses npx jasmine <compiled spec> instead of editing spec/jasmine-runner.ts.
CLAUDE.md now only imports AGENTS.md (@AGENTS.md).
.agents/README.md (new): what each skill does, how the skills fit together, example requests, and how to maintain or add skills.

Related Issue

Closes #1839

Type of Change

Bug fix (non-breaking change that fixes an issue)
New feature (non-breaking change that adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)
Documentation update
Refactoring / code cleanup
Build / CI configuration change

Affected Packages

igniteui-cli (packages/cli)
@igniteui/cli-core (packages/core)
@igniteui/angular-templates (packages/igx-templates)
@igniteui/angular-schematics (packages/ng-schematics)
@igniteui/mcp-server (packages/igniteui-mcp)

Checklist

I have tested my changes locally (npm run test)
I have built the project successfully (npm run build)
I have run the linter (npm run lint)
I have added/updated tests as needed
My changes do not introduce new warnings or errors

Additional Context

Copilot

🟡 Changes recommended

Validation guidance misses hidden project manifests and Angular template tests, and misidentifies Angular’s test runner.

3 open findings

Generated Angular specs are not executed · New
Hidden projects are skipped by --all-projects validation · New
Angular test runner is incorrectly identified as Karma · New

What changed in this PR

Adds ACS-style agents and reusable skills for maintaining Ignite UI CLI templates, versions, testing, and changelogs.

Changes:

Adds template-version, component-template, and changelog agents.
Documents build, smoke-test, and template workflows.
Defines shared context, permissions, and ACS metadata.

File	Description
`.agents/README.md`	Documents agent usage and maintenance.
`.agents/main.yaml`	Defines the ACS manifest.
`.agents/context/project.md`	Establishes agent working rules.
`.agents/permissions/policy.yaml`	Documents access boundaries.
`.agents/agents/template-version-update-agent.md`	Defines version-update automation.
`.agents/agents/component-template-agent.md`	Defines component-template creation.
`.agents/agents/changelog-agent.md`	Defines release-note generation.
`.agents/skills/igniteui-cli-build-test/SKILL.md`	Documents build and test commands.
`.agents/skills/igniteui-cli-smoke-test/SKILL.md`	Documents smoke-test execution and triage.
`.agents/skills/igniteui-cli-template-anatomy/SKILL.md`	Documents template structure and version pins.

🧠 Review effort: Balanced

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

coveralls · 2026-10-09T08:37:36Z

coverage: 94.559%. remained the same — mstoyanova/custom-agents into master

kdinev · 2026-10-09T10:46:16Z

@Marina-L-Stoyanova @ChronosSF flagged to me that ACS is abandoned. Could you sync to determine what new standard we should follow?

…se Vitest

…I/igniteui-cli into mstoyanova/custom-agents

…oke testing, template anatomy, and version updates - Introduced `igniteui-cli-changelog` skill for drafting changelog sections based on merged PRs. - Added `igniteui-cli-component-template` skill to create component templates for Angular, React, and Web Components. - Created `igniteui-cli-smoke-test` skill to verify the installation and build process of generated projects. - Developed `igniteui-cli-template-anatomy` skill to outline the structure and version pinning of templates across frameworks. - Implemented `igniteui-cli-template-version-update` skill to manage and audit Ignite UI package versions in templates.

…est skill

…aging package pins

…I/igniteui-cli into mstoyanova/custom-agents

…ting and template processing

…across frameworks

…rver interaction

… improved cloud agent integration

Copilot

🟡 Changes recommended

The version-update utility can create partial or incompatible updates by mishandling shared pins, stop statuses, and registry failures.

4 open findings

3 resolved since last review

🧠 Review effort: Balanced

…ict handling and status reporting

Copilot

🔵 Needs a closer look

Framework-scope handling and targeted peer validation can produce incorrect workflow results.

1 open finding

Update PR description to reflect executable workflow and scripts

3 resolved since last review

Previously missed (4)

In code that hasn't changed since last review

Expand the all framework input before validation

.agents/skills/igniteui-cli-ai-config-skills-refresh/scripts/sync-skills.mjs:27

all is advertised as a valid framework input, but this parser leaves it as ["all"], after which the unknown-framework check exits with an error. Expand that value to every source framework before validation.

Validate main package peer ranges during targeted runs

.agents/skills/igniteui-cli-template-version-update/scripts/template-pins.mjs:175

When --package narrows the run (for example to igniteui-grid-lite), inScope excludes the framework's main package, so this loop never checks igniteui-angular's peer range. That contradicts the workflow's requirement to validate the main package even when it is not changing and can allow a targeted update that violates its peer dependency. Include main-package pins in metadata/peer validation while keeping them out of the apply set.

Correct PR classification for executable workflow changes

.agents/skills/igniteui-cli-template-version-update/scripts/template-pins.mjs:4

The PR description states that this is documentation-only, but this executable script can rewrite template pins with --apply (and the PR also adds an active GitHub Actions workflow). Update the description, change classification, and validation notes so reviewers and release tooling assess the operational changes accurately.

This issue also appears on line 31 of the same file.

Remove or correct the ineffective agent rules document

.claude/agent-rules.md:4

The linked .claude/agents/ directory does not exist, and .agents/README.md explicitly says there are no custom agent files. This new rules document therefore has no actual agent scope; remove it or point it at the real .agents/skills/ scope and align its commit policy with AGENTS.md.

🧠 Review effort: Balanced

Copilot

🟡 Changes recommended

The helper scripts have unresolved dependency-validation, synchronization, and response-decoding defects.

3 open findings

1 resolved since last review

Update PR description to reflect executable workflow and scripts

🧠 Review effort: Balanced

+	for (const p of inScope.filter((x) => isIgnite(x.name) && x.resolved)) {
+		checks.set(`${p.fw}|${p.name}|${p.resolved}|current`, { fw: p.fw, name: p.name, version: p.resolved, when: "current" });
+		if (updating(p)) checks.set(`${p.fw}|${p.name}|${p.target}|after`, { fw: p.fw, name: p.name, version: p.target, when: "after" });


Removed duplicate deletion and pruning of empty directories. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

feat: Add custom agents and skills for Ignite UI CLI

da5e181

Copilot AI balanced review requested due to automatic review settings October 9, 2026 08:33

Copilot started reviewing on behalf of Marina-L-Stoyanova October 9, 2026 08:34

View session

Copilot AI reviewed Oct 9, 2026

View reviewed changes

Comment thread .agents/agents/component-template-agent.md Outdated

Comment thread .agents/agents/template-version-update-agent.md Outdated

Comment thread .agents/skills/igniteui-cli-template-anatomy/SKILL.md Outdated

kdinev and others added 4 commits October 9, 2026 13:47

Merge branch 'master' into mstoyanova/custom-agents

aadd7ca

fix: Update testing instructions for Angular and React templates to u…

f9e82cc

…se Vitest

Merge branch 'mstoyanova/custom-agents' of https://github.com/IgniteU…

76fc41a

…I/igniteui-cli into mstoyanova/custom-agents

chore: removing custom agents and adding skills

32dbc30

Marina-L-Stoyanova added the 🛠️ status: in-development label Oct 12, 2026

Marina-L-Stoyanova and others added 4 commits October 12, 2026 13:27

refactor: streamline skills documentation and remove obsolete build-t…

0dd281d

…est skill

feat: enhance template version update process with new script for man…

143783d

…aging package pins

Merge branch 'mstoyanova/custom-agents' of https://github.com/IgniteU…

98298ab

…I/igniteui-cli into mstoyanova/custom-agents

Marina-L-Stoyanova requested a review from dkalinovInfra October 12, 2026 13:38

dkalinovInfra and others added 5 commits October 13, 2026 06:55

docs: update SKILL.md and AGENTS.md for improved clarity on smoke tes…

fd521d0

…ting and template processing

feat: add ai-config skills refresh workflow to sync Ignite UI skills …

1d87dea

…across frameworks

feat: add igniteui-cli-mcp-tool skill and call-tool script for MCP se…

b1d13e7

…rver interaction

feat: update agent skills documentation and workflows for clarity and…

efb1b4e

… improved cloud agent integration

Merge branch 'master' into mstoyanova/custom-agents

21b9845

Marina-L-Stoyanova requested a balanced review from Copilot October 13, 2026 08:31

Copilot started reviewing on behalf of Marina-L-Stoyanova October 13, 2026 08:32

View session

Copilot AI reviewed Oct 13, 2026

View reviewed changes

feat: enhance template version update script with improved peer confl…

9338fa1

…ict handling and status reporting

Marina-L-Stoyanova requested a balanced review from Copilot October 13, 2026 13:01

Copilot started reviewing on behalf of Marina-L-Stoyanova October 13, 2026 13:01

View session

Copilot AI reviewed Oct 13, 2026

View reviewed changes

Marina-L-Stoyanova added ❌ status: awaiting-test and removed 🛠️ status: in-development labels Oct 14, 2026

Marina-L-Stoyanova requested a balanced review from Copilot October 16, 2026 10:16

Copilot started reviewing on behalf of Marina-L-Stoyanova October 16, 2026 10:17

View session

Copilot AI reviewed Oct 16, 2026

View reviewed changes

Marina-L-Stoyanova and others added 3 commits October 16, 2026 13:26

Refactor skill sync logic to avoid redundancy

3ea38ed

Removed duplicate deletion and pruning of empty directories. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Set encoding for server stdout and initialize buffer

e987c4c

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

fix: improve peer conflict handling in template version update script

01dddf7

Navigation Menu

Repository navigation

feat: Add custom agents and skills for Ignite UI CLI - #1840

feat: Add custom agents and skills for Ignite UI CLI#1840
Marina-L-Stoyanova wants to merge 18 commits into
masterfrom
mstoyanova/custom-agents

Marina-L-Stoyanova commented Oct 9, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

coveralls commented Oct 9, 2026 •

edited

Loading

Uh oh!

kdinev commented Oct 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

Marina-L-Stoyanova commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Skills

Other changes

Related Issue

Type of Change

Affected Packages

Checklist

Additional Context

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

coveralls commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

kdinev commented Oct 9, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Marina-L-Stoyanova commented Oct 9, 2026 •

edited

Loading

coveralls commented Oct 9, 2026 •

edited

Loading